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Intended Audience 


This manual is intended primarily for system programmers and application 
programmers. 





Document Structure 


This document consists of the following three sections: 


Description—This section is in Part I. It provides a description of the 
National Character Set (NCS) Utility and detailed instructions on how to 
build NCS definition files. 


Usage Summary—This section is in Part II. It outlines the following NCS 
information: 


- Invoking the utility 

~ Exiting from the utility 

- Directing output 

- Restrictions or privileges required 


Qualifiers—This section is in Part II. It describes the NCS qualifiers, 
including format, parameters, and examples. 





Associated Documents 


For related information about the NCS Utility, see the following documents: 


VMS DCL Dictionary 

Guide to VMS Programming Resources 
VMS Sort/Merge Utility Manual 

VMS Librarian Utility Manual 
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Conventions 


Convention 


CTRL/C 


$ SHOW TIME 
05-JUN-1988 11:55:22 


$ TYPE MYFILE.DAT 


input-file, ... 


[logical-name] 


quotation marks 
apostrophes 


Meaning 


In examples, a key name (usually abbreviated) 
shown within a box indicates that you press 

a key on the keyboard; in text, a key name is 
not enclosed in a box. In this example, the key 
is the RETURN key. (Note that the RETURN 
key is not usually shown in syntax statements 
or in all examples; however, assume that you 
must press the RETURN key after entering a 
command or responding to a prompt.) 


A key combination, shown in uppercase with a 
slash separating two key names, indicates that 
you hold down the first key while you press the 
second key. For example, the key combination 
CTRL/C indicates that you hold down the key 
labeled CTRL while you press the key labeled C. 
In examples, a key combination is enclosed in a 
box. 


In examples, system output (what the system 
displays) is shown in black. User input (what 
you enter) is shown in red. 


In examples, a vertical series of periods, or 
ellipsis, means either that not all the data that 
the system would display in response to a 
command is shown or that not all the data a 
user would enter is shown. 


In examples, a horizontal ellipsis indicates 
that additional parameters, values, or other 
information can be entered, that preceding 
items can be repeated one or more times, or 
that optional arguments in a statement have 
been omitted. 


Brackets indicate that the enclosed item is 
optional. (Brackets are not, however, optional 
in the syntax of a directory name in a file 
specification or in the syntax of a substring 
specification in an assignment statement.) 


The term quotation marks is used to refer 
to double quotation marks ("). The term 
apostrophe (’) is used to refer to a single 
quotation mark. 





Part |—Introduction to the National Character Set 
(NCS) Utility 


Part | introduces you to the National Character Set (NCS) Utility and 
provides details about building NCS definition files. 





NCS Description 


In processing strings, two common functions are collating and conversion. 
Collating sequences provide a means of comparing strings for sorting 
purposes; conversion functions provide a means for deriving an altered 
form of an input string based on a conversion algorithm. 


The National Character Set (NCS) Utility provides a common facility for 
defining collating sequences and conversion functions, registering them as 
definition modules in an NCS library, and providing a means for making 
them locally accessible to application programmers and system programmers. 
See Appendix A for a listing of the definition modules that are included in 
the default NCS library. 


Typically, NCS collating sequences are selective subsets of the Multinational 
Character Set. NCS collating sequences find widespread use in international 
applications. For example, a Spanish collating sequence would resolve sorting 
weights for characters you might encounter when processing strings from the 
Spanish language. 


NCS permits you to build collating sequences unique to your particular 
programming situation. For example, if you want the character C to collate 
between the characters G and H, you can retrieve the particular collating 
sequence from a central library, make the appropriate modifications, and 
then store the modified collating sequence in a local library that is readily 
accessible to your application program. 


You can implement NCS from an application program using the program 
interface that includes 10 callable NCS routines. The callable routines permit 
you to access collating sequences and conversion functions stored as definition 
modules in an NCS library. You can also use the NCS routines to save the 
definitions in a local library for subsequent use by comparison and conversion 
routines called from the application program. For instructions on using the 
NCS routines, see the VMS Utility Routines Manual. 


This manual provides information about how to use NCS interactively, using 
the DIGITAL Command Language (DCL) interface for doing the following 
library operations: 


e Creating NCS libraries 

e Inserting definition modules in NCS libraries 

e =Replacing definition modules in NCS libraries 

e Extracting definitions from NCS library modules 
e Deleting definition modules from NCS libraries 


e Other tasks associated with library operations, including listing the library 
contents, directing the output of the library, and logging library activities 


By default, DCL attempts to replace definition modules in the default NCS 
library with definitions from a specified source file. That is, if you specify no 
qualifiers, DCL assumes you want to replace definition modules in the default 
NCS library. If you specify no definition source file, DCL prompts you for 
one, as shown in the following example. 
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NCS Description 


$ NCS 
_File: 


Any other library activity requires you to use one or more command 
qualifiers. You may designate any NCS library as the object of a command 
by assigning it the logical name NCS$LIBRARY. 


The rest of Part I provides instructions for building NCS definition files. 





1 How to Build an NCS Definition File 


The following subsections describe the language syntax you must use when 
building NCS collating sequence definitions and NCS conversion function 
definitions. You can use any standard text editor to build definition files. 


All definition files have the following characteristics: 
¢ Include one or more definitions. 


¢ Have no restriction on including a mix of collating sequence definitions 
and conversion function definitions in a single definition file. 


e Use the file type NCS. 
e Have comments delimited by an exclamation point (!). 


¢ Do not permit line continuation for comments. 


1.1 Naming NCS Definition Files 


Each definition file should begin with a name that describes its contents. 

For example, if you want to convert strings of multinational characters 

to lowercase, use a name like MULTI_TO_LOWER. You can name NCS 
definition files using up to 31 characters including the letters A through Z and 
a through z, the numbers 0 through 9, the dollar sign ($), and the underscore 
character (_). Note that spaces are not allowed and that you may use either 
uppercase or lowercase letters when formulating definition names. 


1.2 Structuring a Definition File 
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Each definition file consists of the following elements, in this order: 
1 Definition name 

2 Equal sign (=) 

3 Definition expression 


4 Terminating semicolon (;) 


A definition file has the following format: 


definition_name = definition_expression; 
definition_name = definition—expression; 


definition_name = definition—expression 


NCS Description 


Example NCS-1 includes excerpts from a definition file that provides several 
EDT conversion functions. 


Example NCS-1_ Typical Definition File 


! Define the EDT fallback conversion function, and UNEDT, its inverse. 

! Note that applying EDT and then UNEDT to a file may not result in the 

! original file, if, for example, the original file contains the string ""A". 
' 


EDT_VT2xx = CF( 
CF = _IDENTITY, 
MODIF ICATIONS=( 


4X00 = "7@", 
YXOL = "7A", 
4X02 = "7B", 


“XFO = "<XFO>", 

“%XFE = "<XFE>", 

“XFF = "<XFF>")) ; 
UNEDT_VT2xx = INVERSE(EDT_VT2xx) ; 
! 


Start of definition EDT (a modified version of EDT_VT2xx) 
! 
EDT = CF( 

CF = EDT_VT2xx, 

MODIF ICATIONS=( 


%4XAO = "<XAO>", 
“XAL = "<tl>t, 
U4XA2 = "<C/>", 
YXFB = "<u>", 
UXFC = Wey 
4XFD = ney Ata" ))3 


!Definition UNEDT (the complement of EDT) 


UNEDT = INVERSE(EDT) ; 
1 
!The next 2 definitions - EDT1 and UNEDT1 - are structured such that ... 
! UNEDT1 (EDT1 (string) ) 
!... always gives the original string. 
! 
EDT1 = CF(CF=EDT,MODI=( 
won = Ash 
nel = "<s")); 
t 


!'The complement of EDT1 
' 


UNEDT1 = INVERSE(EDT1) ; 





Section 1.3 describes the notation used in NCS definitions. The expressions 
and keyword clauses that comprise NCS definitions are described in Sections 
1.5 and 1.6. 
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1.3 


NCS Description 





Notation Guidelines 
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Table NCS-1 lists the language notation to be used in NCS definition files. 


Table NCS-—1 NCS Language Notation 


Notation Meaning 








| Starts a comment 
() Establishes entity grouping for ordering operations. 


In a collating sequence clause, reads literally left term 
collates as right term; in a conversion function clause, 
reads literally term converts to right term 


V 


In a collating sequence clause, reads literally left term 
collates just greater than right term 


< In a collating sequence clause, reads literally left term 
collates just less than right term 


+ 


Within a clause, indicates string concatenation; in an 
expression, indicates an appended collating sequence 


. Indicates a series of expressions comprising one definition 
_ Indicates a range of string data 

Encloses literal string data 

% Indicates the start of a string numeric value 

D Indicates a decimal numeric value 

H Indicates a hexadecimal numeric value 

O Indicates an octal numeric value 


Delimits expressions and clauses 


~ 


Terminates an NCS definition 


we 





You can construct a definition in free form using indentation and one item 
per line to improve readability. For example, the following definition is 
functionally acceptable, but is difficult to read: 


FRENCH NRC_TO MULTI = 
CF (CF=_IDENTITY, MODIFICATIONS= 
(tet P w@ronran " [ Wu On P 


WS tat. a RSUGi " { Wat en 


"| reat, ny Haan MAgnaNgn 
wAgtuungay town Ft _ 
eN="S" MW AgMatgn, TAy tat Qn, 
ee ae Hoqtangn Neont=rs) 
ZK-657 1-HC 


Using indentation and one item per line makes the same definition much 
easier to read: 


1.4 


_NCS Description 


FRENCH NRC_TO MULTI = CF( 


CF = IDENTITY, 
MODIFICATIONS= ( 
"En = we 
wet = va, 
hi [" = daar 
my = hat. 
"j Ww = uSol 
ae A = hem 
tt | wt = "a, 
ey —_ wel 
Wag" = ma 
" “et! = ve. 
Wao" = NO" 
" 4u" = ioe hae 
"oat! = va" 
Noel = "Ee", 
uot = "S6")) 
ZK-6572-HC 


When you format a file for readability, do not omit the required punctuation. 


Strings can be represented literally and numerically. If you use literal strings 
(as in the preceding example), you must enclose them in double quotation 
marks ("). 


If you choose to represent strings numerically, you can use either decimal, 
hexadecimal, or octal numbers. You must precede numeric values by a 
percent sign (%) and the appropriate radix symbol (D for decimal, X for 
hexadecimal, O for octal). Note that you can use only digits that represent a 
single character, and that the radix notation must be less than decimal 256, 
regardless of the numbering system you use. 


For example, the following statement from the previous example may be 
coded using a literal string or a numeric string: 


"en = "a", | literal string 
"~e" = "ZXEB", ! "e" represented as hexadecimal number 


Numeric strings are particularly appropriate when processing characters from 
either the ASCII subset or the EBCDIC subset. 


Built-In Collating Sequences and Conversion Functions 


NCS includes two built-in definitions: the _NATIVE collating sequence 
and the _IDENTITY conversion function. You use the built-in definitions 
as a basis for creating other collating sequences and conversion functions. 
The built-in definitions are distinguished by the leading underscore in their 
names. Note that the built-in collating sequence and the built-in conversion 
function are not stored in the NCS library and cannot be modified. 


The _NATIVE collating sequence collates strings by ascending numeric value. 
For collating purposes, the null character (NUL) has the lowest value of all 
characters in the set. 


Following is an example of how you might use the _NATIVE collating 
sequence to specify a collating sequence: 


MY_CS = _NATIVE * (MULTI_TO_NODIACRITICALS + MULTI_TO_LOWER) 
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NCS Description 


The _IDENTITY conversion function reproduces each input string character 
as an output string character, except for characters that are explicitly being 
modified. Following is an example of using the _IDENTITY conversion 
function: 


MY_CF = CF(CF = _IDENTITY, 


MODIFICATIONS=("ME" = "yOU" 
"NOW" = "THEN" 
"BLUE" = "RED") 


Using this conversion function, the input string Tell me now the sky is blue is 
converted to the output string Tell you then the sky is red. 


1.5 Definition Expressions 


1.5.1 


1.5.1.1 


1.5.1.2 


new_collating_sequence 
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You can define collating sequences and conversion functions using various 
types of expressions. Section 1.5.1 describes the types of expressions used 
in formulating collating sequences. Section 1.5.3 describes the types of 
expressions used to define conversion functions. 


Note that vertical ellipses are used in some examples to indicate omitted code. 
Collating Sequence Expressions 


You can define collating sequences using any combination of the following 
types of expression: 


¢ The name of an existing collating sequence 

e A sequential series of collating sequences 

e An expression that includes appended collating sequences 
e A modified collating sequence 

e A reversed collating sequence 

e A reordered collating sequence 

Definition Name 


You can create a new collating sequence by equating it to the name of an 
existing collating sequence, using the following format: 


new_collating_sequence = name_of_existing_collating_sequence, 
Following is an example of this type of expression: 
MY_COLLATING_SEQUENCE = MULTINATIONAL_1, 

Sequential Series of Expressions 

You can create a new collating sequence from a sequential series of 


expressions, including one or more conversion functions and an existing 
collating sequence, in the following format: 


= collating_sequence * conversion_function_1 * conversion_function—2, 


NCS processes the conversion functions first, going from right to left, and 
then applies the collating sequence. All processes are completed within a 
single pass. 


NCS Description 


Following is an example of using a sequential series of expressions to create a 
collating sequence: 


MY_COLLATING_SEQUENCE = CS(CS = _NATIVE * MULTI_TO_NODIACRITICALS * MULTI_TO_UPPER) , 


1.5.1.3 


new_collating_sequence 


new_collating_sequence 


The conversion functions convert uppercase letters to lowercase letters and 
strip the diacritical marks. The result is then combined with the _NATIVE 
collating sequence to derive a collating sequence that behaves as though the 
input strings have been converted and then compared by their numeric value. 


Expression with Appended Collating Sequences 
You can create a collating sequence using an existing collating sequence and 
up to two appended collating sequences, in the following format: 


= collating_sequence_1 + collating_sequence_2 + collating_sequence_3, 


NCS processes the leftmost collating sequence in the first pass, and proceeds 
to process each of the remaining collating sequences going from left to right, 
using an individual pass for each. 


You can include conversion functions with each of the collating sequences 
using the asterisk (*) operator, in the following format: 


= collating_sequence_1 * conversion_a * conversion_b + ... + ..., 


Although there is no limitation on the number of conversion functions 

you can use with each collating sequence, you should try to minimize the 
complexity of the expression by limiting the number of conversion functions. 
In a complex expression having several collating sequences with associated 
conversion functions, NCS applies conversion functions only to the related 
collating sequence. When NCS detects a distinction between the two strings 
being compared, the comparison function terminates. 


Following is an example of creating a collating sequence using an existing 
collating sequence with an appended collating sequence: 


MY_COLLATING_SEQUENCE = CS(CS = MULTINATIONAL_1 + MULTINATIONAL_2 * UPCASE * NODIACRITICALS) , 


1.5.1.4 


Modified Collating Sequence 
You can create a collating sequence from a modified collating sequence using 
keyword clauses, in the following format: 


new_collating_sequence = CS(keyword_clause,keyword_clause, ...), 


The expression begins with a definition identifier (CS) followed by several 
keyword clauses enclosed in parentheses and separated by commas. The first 
keyword clause identifies the collating sequence that serves as a basis for the 
new collating sequence, and the second keyword clause lists the appropriate 
modifications. 


Following is an example of an expression that uses keyword clauses to create 
a new collating sequence by modifying an existing collating sequence. Each 
uppercase character gets the same collating weight as the associated lowercase 
character. 


MY_COLLATING_SEQUENCE = 


CF(CF = _IDENTITY, ! Base collating sequence 
MODIFICATIONS=( 
“X41-4%X5A = %X61-ZX7A, ! Modifications 
*XCO-Z%XCF = %XEO-%XEF , ! to the base 


4XD1-%XDD = %XF1-%XFD));  ! collating sequence 
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NCS Description 


1.5.1.5 Reversed Collating Sequence 
You can create a new collating sequence by specifying the reverse order of an 
existing collating sequence, using the following format: 


new_collating_sequence = REVERSE(existing_collating_sequence) 


Using this form of expression, you might create a collating sequence where 
the letter C would collate greater than B, and the letter B would collate greater 
than A. 


Here is an example of using a reverse order collating sequence expression: 
MY_COLLATING_SEQUENCE = REVERSE(_NATIVE) , 


Using this expression, you could give collating weight precedence to 
lowercase characters over uppercase characters. 


1.5.1.6 Reordered Collating Sequence 
You can create a new collating sequence by reordering an existing expression 
through the use of parentheses. 


In the following example, NCS applies the conversion_function and compares 
the input strings using collating_sequence_b as a comparison basis in the 
first pass. If the strings do not compare, NCS compares the strings using 
collating_sequence_a as a basis during a second pass. 


old_collating_sequence = collating_sequence_a + collating.sequence_b * conversion_function, 


If you want to do the comparisons in a single pass using the sum of the 
collating sequences, reorder the operation using parentheses, as shown in the 
following example: 


new_collating_sequence = (collating_sequence_a + collating _sequence_b) * conversion—function, 


1.5.2 Collating Strings with Pad Characters . 
In some instances, you may need to collate strings padded with one or more 
pad characters. Typically, a string may be padded with the ASCII SPACE 
character, but the pad character can be defined as any character. In order to 
avoid ambiguity when collating padded character strings, specify the collating 
value of the pad character in your collating sequence definition. For example, 
if you want to specify the collating weight of a pad character in a collating 
sequence, you might use the following statement: 


NATIVE_SPACEPAD = CS(CS=_NATIVE, MOD = ("" = %X20)); 


This states that the shorter string should be treated as if it were padded with 
spaces for collating purposes. For example, the string ABC <SP> <SP> 
would have the same collating weight as the string ABC. 
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1.5.3 


1.5.3.1 


1.5.3.2 


1.5.3.3 


NCS Description 


Conversion Function Expressions 
You can define conversion functions using any combination of the following 
types of expression: 


e The name of an existing conversion function 

e A sequential series of conversions 

e A modified conversion function 

e An inverted conversion function 

e A reordered conversion function 

Definition Name 

You can create a new conversion function from an existing conversion 


function by equating the new function to the name of the existing function, 
using the following format: 


new_conversion_function = name_of_existing_conversion_function; 
Following is an example of this type of expression: 


MY_CONVERSION = MULTI_TO_LOWER; 


Sequential Series of Conversions 
You can create a new conversion function by expressing it as the result of a 
sequential series of conversions, using the following format: 


new_conversion_function = conversion_1 * conversion_2 * conversion_3; 


NCS applies a sequential series of conversions in a single pass beginning 
with the rightmost conversion and continuing right to left. In the preceding 
format, conversion—_3 is applied before conversion_2, and conversion_2 before 
conversion —1. 


Following is an example of a conversion function derived through a sequential 
series of conversions: 


MY_CONVERSION = MCS_NODIACRITICALS * MCS_LOWER; 


Modified Conversion Function 

You can create a conversion function from another conversion function 
appropriately modified through the use of keyword clauses, in the following 
format: 


new_conversion_function = CF(keyword_clause,keyword_clause, ...) 


The expression begins with a definition identifier (CF) followed by several 
keyword clauses enclosed in parentheses and separated by commas. The first 
keyword clause identifies the conversion function that serves as the basis for 
the new conversion function. The second keyword clause lists the appropriate 
modifications. 


Following is an example of an expression that uses keyword clauses to create 
a new conversion function: 


EDT1 = CF(CF=EDT,MODIFICATIONS=( 


i em i Li cera) 
2 


Wen "<=")); 


In this example, the new conversion function (EDT1) is a modified 
representation of an existing conversion function (EDT). 
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NCS Description 


1.5.3.4 


1.5.3.5 


Inverted Conversion Function 
You can create a new conversion function by logically inverting an existing 
conversion function, using the following format: 


new_conversion_function = INVERSE(CF_expression) 


Typically, you use inversion when you want to restore a converted string to 
its original form. For example, assume you have the following conversion 
function: 


EDT1 = CF( 


CF = _IDENTITY, MODI = ( 


“X01 = "A", 
%X02 = "“B", 
4X03 = "°C", 
“X04 = "“D", 
%X05 = ""E", 
4X06 = es aL 
4X07 = weg 
Tr %X00)); 


Now assume you want to convert the output string back to the original input 
string. To do this, you can use the following conversion function: 


UNEDT1 = INVERSE(EDT1) 


Reordered Conversion Function 

You can effectively reorder conversion functions using parentheses. For 
example, the following format results in a two-pass comparison where 
collating_sequence_a is used as the basis for comparing the input strings 
during the first pass: 


my_cs = collating_sequence_a + collating _sequence_b * conversion_c * conversion_d, 


If the strings do not compare, conversion—d and conversion—c are applied to 
the input strings and then the strings are compared on the second pass based 
on collating_sequence_b. 


If you want a one-pass comparison that converts input strings and then 
compares them using the composite effects of collating_sequence_a and 
collating_sequence_b, add parentheses, as follows: 


my—cs = (collating_sequence_a + collating_sequence_b) * conversion_c * conversion—ad, 
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1.6 Keyword Clauses 


1.6.1 


1.6.1.1 


NCS Description 


Keyword clauses are the basic elements of a collating sequence definition. 
They are used to establish the basis for each collating sequence, to explicitly 
define modifications where applicable, and to optionally assign a version 
number to the collating sequence. 


As described previously, a definition expression can take the form of a 
definition identifier (CS or CF) followed by a set of one or more keyword 
clauses enclosed in parentheses and separated by commas, as follows: 


new__expression = CS(keyword_clause,keyword_clause, ...) 


All keyword clauses begin with a keyword followed by the equal sign and a 
value: 


keyword = value 
The value varies with the keyword, as shown in the next two sections. 


Note that you can abbreviate any keyword as long as the abbreviated form is 
not ambiguous. 


Collating Sequence Keyword Clauses 
There are four types of keyword clauses you can use to build a collating 
sequence expression: 


e CS 
e SEQUENCE 
e IDENT 


e MODIFICATIONS 


Each of these is described in the following subsections. 


CS Keyword Clause 

The CS keyword clause equates the keyword CS to a collating sequence 
expression that can take any one of the forms described in Section 1.5. The 
CS keyword clause typically establishes the collating basis for a collating 
sequence unless you use the SEQUENCE keyword clause. The CS keyword 
clause uses the following format: 


CS = CS_expression 
The following example illustrates the use of the CS keyword clause: 


MULTINATIONAL_2 = CS( ! Define temporary for second pass. 
IDENT = "V1.0", 
CS = _NATIVE * MULTI_TO_UPPER, 
MODIF ICATIONS= ( 
4XC6 > "Z", ! AE diphthong 
4XD8 > %XC6, ! 0 with slash 


+XEO-/,XEF 
*XF 1-7,XFD 


4XCO-%XCF , 
%XD1-%XDD ) ); 
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1.6.1.2 


DUTCH = CS ( 
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SEQUENCE Keyword Clause 

The SEQUENCE keyword clause establishes the collating basis for a collating 
sequence when the CS keyword clause is not appropriate. Typically, you use 
this keyword clause when you do not have an existing collating sequence that 
is appropriate for your application and thus must fabricate one. 


The following example illustrates the use of the SEQUENCE keyword clause 
in fabricating the Dutch collating sequence: 


SEQUENCE (SXOO-"N", ba haa Le eae Ae a ees a ee Pata. AMEN XD, 
SXDE, SXFO, *SXFE-SXFF), 

MODIFICATIONS=("a"—-"zZ" = TANS ZN wAronAw = 1AM. SOW nes Ls oye Wo mein LS a 
upwlete = pS Hos wOuongn = fou: eee 6 aL = ib 8 Baie nyt = ye, wating = ea 
WAN tet s MANU E", haw NEM) ee eee Le eT A = eS ae 
MGSO Ce OMG Mg ee EO AG Math ee Ie, tgp = gt, a MOBS 
UB eS Si. agi eI SA ee KOO): ) 


+ CS ( SEQUENCE = (SXO0O-"A", ee Uo oes Ole rON, OF 8 a 8 As 
tpwloape : "] yaa PO ls sare a Sas tLe ror, nononon ; Mwpitouptt : nan r 
Wet ait. A Oe 0 ae mT YE eae nga a ee ng, WAT Le a ee Ue Lae 


SXDO, GXDE, %SXFO, %XFE-%XFF), 
MODIFICATIONS= Chats ttg" = VAN="Z2", A eh = HAMS TS, Mr eye = Ty) ) 


+ REVERSE (_NATIVE) ; 


1.6.1.3 


ZK-6573-HC 


In this example, the first SEQUENCE keyword clause establishes-the collating 
sequence for the entire character set from %X00 through %XFF during the 
first pass. The associated MODIFICATIONS keyword clause effectively masks 
the lowercase characters and diacritical characters by equating each lowercase 
alphabetical character to its related uppercase alphabetical character, and 

by equating each diacritical character to its related nondiacritical, uppercase 
character. 


During the second pass, the second SEQUENCE keyword clause establishes 
the collating sequence for the diacritical characters. The associated 
MODIFICATIONS keyword clause masks all lowercase characters, both 
diacritical and nondiacritical, by equating them to their related uppercase 
character. 


IDENT Keyword Clause 

The IDENT keyword clause is a special-purpose keyword clause that permits 
you to assign a version number to the collating sequence. The following 
example illustrates using the IDENT keyword to assign Version 1.0 to the 
Spanish collating sequence: 


SPANISH = CS( 
IDENT = "V1.0", 
CS = MULTINATIONAL, 


Re 


1.6.1.4 


1.6.2 


1.6.2.1 


NCS Description 


MODIFICATIONS Keyword Clause 

The MODIFICATIONS keyword clause is typically used with the built-in 
collating sequence NATIVE to derive a modified version of the collating 
sequence. 


In the following example, the new collating sequence 
(MULTINATIONAL —1) applies two conversion functions 
(MULTI_TO_NODIACRITICALS and MULTI_-TO_UPPER) to the input 
strings. Then the collating sequence uses a modified version of the built-in 
collating sequence, _NATIVE, as the basis for comparing the strings. 


The first group of modifications assigns collating weights to the listed special 
characters. For example, the uppercase N tilde character (N) is assigned the 

same collating weight as the alphabetic character (N). The second group of 

modifications gives each lowercase character the same collating weight as the 
associated uppercase character. 


MULTINATIONAL_1 = CS( 
CS = _NATIVE * ( MULTI_TO_NODIACRITICALS * MULTI_TO_UPPER ), 


MODIFICATIONS=( 
! 


! Special characters 
! 


4XC6 


> ay A ! AE diphthong 
%XD8 > %XC6, ! 0 with slash 
%XC5 > %XD8, ! A with ring 
%XDi > "N", ! N tilde 
“XDF = "SS", ! § sharp 
4XD7 = "OE", ! OE ligature 


! 
! Define lowercase to collate the same as uppercase 
! 

XEO-7,XEF 
AXF 1-%XFD 


%XCO-%XCF , 
%4XD1-%XDD 


4 


Conversion Function Keyword Clauses 
There are three types of keyword clauses you can use to build a conversion 
function: 


e §6CF 
e IDENT 
e MODIFICATIONS 


Each of these is described in the following subsections. 


CF Keyword Clause 

The CF keyword clause equates the keyword CF to a conversion function 
expression, which can take any one of the forms described in Section 1.5. 
The general form for the CF keyword clause follows: 


CF = CF_expression 
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The following example illustrates the use of the CF keyword clause: 


MULTI_TO_NODIACRITICALS = CF( 
IDENT = "V1.0", 
CF = _IDENTITY, 
MODIF ICATIONS=( 


4XCO-%XCS5 = "A", ! Various forms of "A" assigned same weight 
U%XFO-ZXFC = "ul, ! Various forms of "u" assigned same weight 
“%XFD = "y" ) ); ! Y umlaut assigned weight of "y" 


See Section 1.4 for details on the use of the _IDENTITY built-in definition. 


1.6.2.2 IDENT Keyword Clause 
The IDENT keyword clause is a special-purpose keyword clause that permits 
you to assign a version number to the conversion function. The following 
example illustrates the use of the IDENT keyword clause to assign Version 
1.0 to a conversion function: 


MULTI_TO_LOWER = CF( 
IDENT = "V1.0", 
CF = _IDENTITY, 
MODIFICATIONS=( 
%X41-%X5A = YX61-%X7A, ! Characters A-Z 


“%XD1-%XDD = %XF1-%XFD ) ); ! Various characters 


1.6.2.3 MODIFICATIONS Keyword Clause 
The MODIFICATIONS keyword clause is used in conjunction with another 
conversion function, typically the built-in conversion function _IDENTITY, to 
derive a modified version of the conversion function. The MODIFICATIONS 
keyword clause causes NCS to modify the specified conversion function, 
making changes in the specified order. 


The following example illustrates the use of the MODIFICATIONS keyword 
clause in a conversion function: 


MULTI_TO_UPPER = CF( 
IDENT = "V1.0", 
CF = INVERSE(MULTI_TO_LOWER) , 
MODIFICATIONS=(%XDF = "SS", %XD7 = "OE");) 


In this example, the MODIFICATIONS keyword clause masks the lowercase 
sharp s (B) by equating it to the character pair SS and the uppercase OE 
ligature (CE) by equating it to the character pair OE. 


1.6.3 MODIFICATIONS Keyword Clause Syntax 
This section expands on the syntax requirements for developing 
MODIFICATIONS keyword clauses in an NCS expression. 


The conversion function MODIFICATIONS keyword clause uses the following 
format: 


left_string = right—string 


NCS—16 


NCS Description 


NCS treats this as left string converts to right string. The following example 
illustrates the use of a MODIFICATIONS keyword clause in a conversion 
function: 


CF = _IDENTITY, 
MODIF ICATIONS=( 
AX41-%X5A = LX61-ZX7A, 


In this example, NCS treats the MODIFICATIONS keyword clause as 
uppercase characters convert to lowercase characters, where the source string is 
a range of hexadecimal numbers representing uppercase alphabetic characters 
and the destination string is a range of hexadecimal numbers representing 
lowercase alphabetic characters. 


Note that the equal sign (=) is always the sign of operation for conversion 
function MODIFICATIONS keyword clauses. 


The various formats for the collating sequence MODIFICATIONS keyword 
clause are listed in Table NCS-2. 


Table NCS—2 Formats for Collating Sequence MODIFICATIONS 
Keyword Clauses 


Format Interpretation 

string = string left string collates as right string 

range = string left range collates as right string 

range = range left range collates as right range 

string > string left string collates just greater than right string 
range > string left range collates just greater than right string 
range > range left range collates just greater than right range 
string < string left string collates just less than right string 
range < string left range collates just less than right string 
range < range left range collates just less than right range 


You can specify a range of values in a keyword clause, using the following 
format: 


string1 - string2 


The following example shows how to assign the left string the same collating 
value as the right string: 


CS = _NATIVE * ( MULTI_TO_NODIACRITICALS * MULTI_TO_UPPER ), 
MODIF ICATIONS=( 
%XDF = "SS", 
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The MODIFICATIONS keyword clause in this example states that the 
hexadecimal value for S sharp (%XDF) has the same collating value as SS. 


The next example shows various source strings being assigned collating values 
that are relatively greater than, less than, and equal to the destination strings: 


MODIF ICATIONS=( 


“%XDF > "S", ! § sharp 
%XD7 < "0", ! OE ligature 
“XF7 = %XD7 ) ); ! oe ligature 


Here the hexadecimal value for S sharp collates just greater than the letter S, 
the hexadecimal value for the uppercase @ ligature collates just less than the 
letter O, and the hexadecimal value for the lowercase @ ligature collates equal 
to uppercase @. 


You can also assign a range of strings the same collating value as a single 
string. For example, if you want to assign all of the lowercase alphabetical 
characters the same collating weight as a null character that typically has the 
lowest collating value in a set, you would state it as follows: 


CS = _NATIVE 
MODIFICATIONS=( 
%X61-7X7A = 7%X00, 


In building a definition file, you can compose a definition that is not 
compatible with NCS because the function is not well defined or because of 
some restriction NCS may impose on the function. In analyzing a definition, 
use the NCS/EXTRACT command to retrieve the function (see Part II). The 
NCS/EXTRACT command restructures the definition in its most basic form. 
The resulting definition may not be as efficient as the original definition but it 
is generally more logically structured and easier to read. 





Part II—NCS Command and Command Qualifiers 


Part Il describes the NCS command and its qualifiers. 


NCS Usage Summary 


The NCS command invokes the National Character Set (NCS) Utility, which 
performs NCS library functions specified by NCS qualifiers. By default, 
NCS tries to replace the definition modules in the default NCS library with 
the definitions in the specified input file. All other NCS library functions 
require explicit command qualifiers. 





PARAMETER 


NCS _finput-filespec] 





PARAMETER 


usage summary 


[input-filespec,...] 

Where applicable, specifies the name of one or more input files containing 
definitions that NCS is to use to perform the action specified by the command 
qualifier. By default, NCS attempts to replace modules in the default NCS 
library with definitions in the input file. 


You must specify an input file when you want to either replace or insert a 
module in the specified NCS library. Specifying an input file is optional when 
you want to create a new library. 


If you specify several input files, you must separate them with commas (, ). 
The default file type for input files is NCS. 


Invoke the NCS Utility by entering the DCL command NCS. The NCS Utility 
exits when the specified command operations are completed. If you use the 
/LIST qualifier, you can direct output to a specified file. If you do not specify 
a file, the output is directed to SYSHOUTPUT. 
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NCS Qualifiers 
NCS Command (Qualifiers 





NCS 


COMMAND 
QUALIFIERS 


You may use one qualifier, no qualifiers, or several qualifiers with the NCS 


command, depending on the library functions you want to perform. Most 
of the qualifiers are compatible with one another and some require that you 
enter a related qualifier to do a specific task. 


Table NCS-3 lists qualifiers that require a related qualifier and qualifiers that 


are incompatible. 


Table NCS—3 NCS Command Qualifier Relationships 


Qualifier 


/BEFORE? 
/COMPRESS 
/CREATE' 
/DATA 
/DELETE 
/EXTRACT 


/FORMAT? 
/FULL? 
/HISTORY? 
/INSERT 
/LIBRARY 


/LIST: 


/LOG 


/ONLY? 
/OUTPUT 
/REPLACE 
/ SINCE? 


Related Qualifiers 


/LIST 

/OUTPUT, /LIBRARY 
/LIBRARY 
/COMPRESS, CREATE 
/LIBRARY 


/LIBRARY, /MACRO, 
/OUTPUT 


/MACRO 
/LIST 
/LIST 
/LIBRARY 


COMPRESS, /CREATE, 
/DELETE, /EXTRACT, 
/INSERT, /LIST, /REPLACE 


/BEFORE, /FULL, 
/HISTORY, /LIBRARY, 
/ONLY, /SINCE, 


/CREATE, /DELETE, 
/EXTRACT, /INSERT, 
/REPLACE 


/LIST 
/EXTRACT 
/LIBRARY 
/LUIST 


incompatible Qualifiers 


/CREATE, /EXTRACT 
/COMPRESS, /EXTRACT 
/EXTRACT, /INSERT, /REPLACE 
/CREATE, /EXTRACT 
/COMPRESS, /CREATE, /DELETE 


/EXTRACT 


/EXTRACT 


/DELETE 
/EXTRACT 


'The /CREATE, /INSERT, and /REPLACE qualifiers are compatible but /CREATE takes precedence. The related qualifiers 
for /CREATE are applicable only if you enter one or more input files. 


2This qualifier is meaningful only when used with the /LIST qualifier. 


3This qualifier is meaningful only when used with the /MACRO qualifier. 
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NCS Qualifiers 
/BEFORE 


/BEFORE 


Lists only the modules inserted in the library before the specified time. 








FORMAT /BEFORE[= time] 
QUALIFIER time 
VALUE The time (and date, where applicable) that NCS uses as the reference cutoff 


point for accumulating the appropriate list of modules. 





DESCRIPTION When you use the /LIST qualifier, NCS lists all the definitions in the NCS 
library by default. However, you can use the /BEFORE qualifier with the 
/LIST qualifier to list only definitions created before a specified time (and 
date, where applicable). You may specify an absolute time or a combination 
of absolute time and delta time. For details on specifying times, see the VMS 
DCL Dictionary. 


If you use the /BEFORE qualifier without specifying the time, the output list 
includes all definitions in the library created before today. 





EXAMPLES 
fF] = $ NCS/LIST/BEFORE=31-DEC-1988: 13:30 


This command lists all definition modules inserted in the default NCS library 
before 1:30 p.m. on December 31, 1988. 


2 $ NCS/LIST/BEFORE=31-DEC-1988 : 09: 00/LIBRARY=USERDISK : [DOE] LIB.NLB 


This command lists all definition modules inserted in user DOE’s local NCS 
library, LIB.NLB, before 9:00 a.m. on December 31, 1988. 
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NCS Qualifiers 
/COMPRESS 


/COMPRESS 


Recovers disk space previously occupied by deleted definition modules. 








FORMAT /COMPRESS[F=(option[....])] 
QUALIFIER option 
VALUE A set of options that permits you to change the size or format of the specified 


library, overriding the values assigned to the library when it was created. See 
the listing under DESCRIPTION. 





DESCRIPTION The /COMPRESS qualifier effectively recers disk space previously occupied 
by modules deleted from an NCS library by creating a more efficiently 
organized output library file. If you do not explicitly specify a destination 
library, NCS creates a new compressed version of the default NCS library. 
When you compress an NCS library, you can override various NCS default 
values for the size and format of the library, using the following options: 


BLOCKS:n Specifies the number of 512-byte blocks to be allocated for 
the library. By default, NCS allocates 100 blocks for a new 
library. 

HISTORY:n Specifies the maximum number of library update history 


records that the library may maintain. By default, NCS sets 
the number at 20. 


KEYSIZE:n Changes the maximum length of definition module names. 
MODULES:n Specifies the maximum number of modules in the NCS library. 





EXAMPLES 


1 $ NCS/COMPRESS= (BLOCKS : 200) /LIBRARY=USERDISK : [DOE] LIB.NLB 


This command compresses user DOE’s local NCS library and simultaneously 
allocates two hundred 512-byte blocks for it. 


2 $ NCS/COMPRESS= (KEYSIZE: 35 , MODULES : 40) /LIBRARY=USERDISK: [DOE] LIB. NLB 


This command compresses user DOE’s local NCS library and specifies a 
maximum key size of 35 bytes together with a maximum of 40 definition 
modules. 
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NCS Qualifiers 
/CREATE 


Creates an NCS library. 





FORMAT 


/CREATE[=(option[,...])] 





QUALIFIER 
VALUE 


option 

A set of options that permits you to override the system defaults for the 
size and format of the newly created NCS library. See the listing under 
DESCRIPTION. 





DESCRIPTION 


Use the /CREATE qualifier to create an NCS library. If you do not use the 
/LIBRARY qualifier to specify a new library, NCS creates a new version 

of the default NCS library. To populate the new library from an existing 
definition file, enter as the command parameter the specification for the input 
file containing the definitions. 


When you create an NCS library, you can override various NCS default 
values for the size and format of the library, using the following options: 


BLOCKS:n Specifies the number of 512-byte blocks to be allocated for 
the library. By default, NCS allocates 100 blocks for a new 
library. 


HISTORY:n Specifies the maximum number of library update history 
records that the library may maintain. By default, NCS sets 
the number to 20. 


KEYSIZE:n Changes the maximum length of definition module names. 
MODULES:n Specifies the maximum number of modules in the NCS library. 





EXAMPLES 


| $ NCS/CREATE=(BLOCKS : 200 , KEYSIZE: 24) /LIBRARY=DISK1: [DOE] LIB.NLB 


This command creates a file named LIB.NLB in the directory DOE, while 
simultaneously allocating the file 200 blocks and setting the maximum 
module name length at 24 characters. 


fs $ NCS/CREATE=MODULES : 40/LIBRARY=USERDISK: [DOE]ABC.NLB MY.NCS 


This command creates an NCS library in directory DOE named ABC.NLB. 
The command limits the library to 40 modules and populates it with 
definitions from input file MY.NCS. 
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NCS Qualifiers 
/DATA 


/DATA 


Improves disk space efficiency. 








FORMAT /DATA= REDUCE 
EXPAND 
QUALIFIER REDUCE 
VALUES Stores definitions in a data-reduced format. 
EXPAND 


Stores definitions in a data-expanded format. 





DESCRIPTION __ The /DATA qualifier gives you the option of specifying how you want 
definitions stored in the NCS library, in data-reduced format or data- 
expanded format. Note that you must specify a value, either REDUCE or 
EXPAND, with this qualifier; there is no default value. Note, too, that NCS 
does an implicit compression (recovers unused space from previously deleted 
files) on the specified library, whether you are converting the library to 
data-reduced form or to data-expanded form. 


If the specified NCS library is in standard (nonreduced) form, use the 
REDUCE option to create a new reduced version of the library. If you do 
not use the /LIBRARY qualifier to specify a library, NCS creates a new 
reduced version of the default NCS library. Note that access to libraries 
in data-reduced format is generally slower than libraries in data-expanded 
format. 


If the specified NCS library is in reduced form, use the EXPAND option to 
create a new expanded (standard) version of the library. If you do not use the 
/LIBRARY qualifier to specify a library, NCS creates a new expanded version 
of the default NCS library. Note that access to libraries in data-expanded 
(standard) format is generally faster than libraries in data-reduced format. 





EXAMPLES 
f] = $: NCS/DATA=REDUCE 

This command maximizes the space efficiency of the default NCS library. 
fF) —s-$-_NCS/DATA=EXPAND SYS$LIBRARY : NCS$LIBRARY 


This command reduces the access time to and space efficiency of the default 
NCS library. 
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NCS Qualifiers 
/DELETE 


/DELETE 


Deletes one or more definition modules from the NCS library. 








FORMAT /DELETE=module{[,...] 
QUALIFIER module 
VALUE The name of the module to be deleted. 





DESCRIPTION The /DELETE qualifier deletes the specified definition module or modules 
from an NCS library. If you specify several modules, separate the definition 
names with commas (,) and enclose the list in parentheses. You may use the 
standard VMS wildcard characters to specify the modules to be deleted. 


If you use this qualifier with the /LIST qualifier, NCS deletes the module 
before it lists the contents of the library. Therefore, the deleted definitions do 
not appear in the output listing. 





EXAMPLES 
fH] = $ ‘NCS/DELETE=CH* 


This command deletes all NCS library modules that begin with the 
letters CH. 


2 $ NCS/DELETE=(LOWER_TO_UPPER , CHANGECASE) /LIST 


This command deletes the definition CHANGECASE from the default NCS 
library and then lists the remaining definitions. 
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NCS Qualifiers 
/EXTRACT 


/EXTRACT 


Extracts definitions from an NCS library. 








FORMAT o /OUTPUT= filespec 
/EXTRACT=modulel....] | Ai Ala ee | 

QUALIFIER module 

VALUE The name of the module to be extracted. 





DESCRIPTION The /EXTRACT qualifier is used to retrieve one or more definition modules 
from an NCS library. Note that you must use either the /OUTPUT 
qualifier or the /MACRO qualifier with the /EXTRACT qualifier to specify a 
destination file for the extracted definition. 


Use the /EXTRACT qualifier with the /MACRO qualifier to extract one or 
more definitions that you want to include in a MACRO-32 program file. 
When you use the /MACRO qualifier with the /EXTRACT qualifier, the 
default output file type is MAR. 


Use the /EXTRACT qualifier with the /OUTPUT qualifier to extract one or 
more definitions that you want to include in an NCS definition file. When 
you use the /OUTPUT qualifier with the /EXTRACT qualifier, the default 
output file type is NCS. 


If you want to extract several modules, separate the module names with 
commas (,) and enclose the list in parentheses. 


You may use any of the standard VMS wildcard characters to specify the 
modules to be extracted. 





EXAMPLES 


| $ NCS/EXTRACT=CHANGECASE/MACRO=MY 


This command extracts the definition CHANGECASE from the default NCS 
library and converts it to MACRO format before storing it in the file MY.MAR. 


fs $: NCS/EXTRACT=(CHANGECASE , UPPER_TO_LOWER) /OUTPUT=MY 


This command extracts two definitions from the default NCS library and 
stores them in the definition file MY.NCS. 
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NCS Qualifiers 
/FORMAT 


/FORMAT 


Specifies the MACRO format appropriate to your program. 








FORMAT _(Ncs 
R = 
/FORMAT { bas |! 
QUALIFIER NCS 
VALUES MACRO-32 format for NCS routines. 
256 


MACRO-32 format for the Run-Time Library routine LIB5|MOVTC. 





DESCRIPTION Use the /FORMAT qualifier with the /MACRO qualifier to specify the 
appropriate MACRO-32 file format. You may select one of two format 
options, either NCS (the default) or 256. If you select the NCS format, NCS 
formats the collating sequence and string conversion tables, or both, for use 
by the NCS routines. If you select the 256 format, NCS formats the collating 
sequence and string conversion tables, or both, as 256-byte tables that can be 
used by the Run-Time Library routine LIB5MOVTC. For more information, 
see the VMS Run-Time Library Routines Volume. 





EXAMPLES 


f] $ NCS/EXTRACT=UP_DOWN/MACRO=MY/FORMAT=256 


This command extracts the definition UP_DOWN from the default NCS 
library and converts it to the 256-byte table format before including it in the 
file MY.MAR. 


FJ = $ NCS/EXTRACT=(ABCDE , XYZ) /MACRO=MY 


This command extracts two definitions from the default NCS library and 
converts them, by default, to NCS format before including them in the file 
MY.MAR. 
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NCS Qualifiers 
/FULL 


/FULL 


Provides a complete listing of an NCS library. 





FORMAT /FULL 





PARAMETERS = None. 





DESCRIPTION Use the /FULL qualifier with the /LIST qualifier to obtain an NCS library 
listing that includes the date and time each module was inserted into the 
library. The output has the following format: 


module inserted dd-mmm-yyyy hh:mm:ss 





EXAMPLE 
$ NCS/LIST/FULL 


This command lists the modules in the default NCS library, together with the 
date and time that each module was inserted into the library. 
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NCS Qualifiers 
/HISTORY 


/HISTORY 


Provides the update history record headers for the NCS library. 





FORMAT /HISTORY 





PARAMETERS None. 





DESCRIPTION You use the /HISTORY qualifier with the /LIST qualifier to obtain a list 
of the update history record headers for the specified NCS library, in the 
following format: 


username operation n modules on dd-mmm-yyyy hh:mm:ss 


The operation may be a replacement, insertion, or deletion of definition 
modules. 


If you specify the /FULL qualifier with the /HISTORY and /LIST qualifiers, 
NCS lists the history record headers for each update, together with a list of 
the definition modules affected by each update. 





EXAMPLES 
f]  $ NCS/LIST/HISTORY 


If you had previously deleted two definition modules from the NCS library, 
this command would produce a listing that includes the following line: 


JONES deleted 2 modules on 31-DEC-1988 16:26:36 


MJ $ -NCS/LIST/HISTORY/FULL 


Making the same assumptions as in the previous example, this command 
would produce a listing that includes the names of the deleted modules: 


JONES deleted 2 modules on 31-DEC-1988 16:26:36 
CHANGECASE 
UPCASE 
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NCS Qualifiers 
/INSERT 


/INSERT 


Adds one or more definition modules to an NCS library. 





FORMAT /INSERT filename 





PARAMETERS = None. 





DESCRIPTION Use the /INSERT qualifier to add one or more definition modules to an NCS 
library from an input file. If the input file contains more than one definition, - 
NCS creates a separate entry in the library for each. 


Before NCS inserts a definition into an existing NCS library, it verifies that 
the library does not already contain a definition module having the same 
name. If NCS finds a definition module with the same name, it does not add 
the new definition module to the library, but it does provide an appropriate 
error message. 





EXAMPLES 


f]  $ NCS/INSERT MY_DEFS 


This command directs NCS to insert each of the definitions from input file 
MY_DEFS.NCS into the NCS library. 


f= $ NCS/INSERT/LIST/HISTORY/FULL MY_DEFS 
This command directs NCS to insert the definitions from input file 


MY_DEFS.NCS into the NCS library; then NCS lists the history of each 
definition module in the library, including those inserted by this command. 
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NCS Qualifiers 
/LIBRARY 








/LIBRARY 
Specifies an alternate NCS library. The default NCS library is 
SYS$LIBRARY:NCS$LIBRARY. 

FORMAT /LIBRARY= filespec 

QUALIFIER filespec 

VALUE The alternate NCS library file specification. 





DESCRIPTION The /LIBRARY qualifier allows you to specify an NCS library other than 
the default NCS library (SYS$LIBRARY:NCS$LIBRARY). Note if you do not 


include a device and directory when you specify the alternate library, NCS 
defaults to SYS$LIBRARY. The default file type is NLB. 





EXAMPLES 


f] $ NCS/INSERT/LIBRARY=USERDISK : [DOE] MY_LIB MY_DEFS 


This command directs NCS to insert definitions from the file MY_DEFS.NCS 
into the NCS library MY_LIB.NLB. 


fF] = $ ~NCS/DELETE=UPCASE/LIBRARY=GEN_NCS 


This command directs NCS to delete the module UPCASE from the library 
file SYS$LIBRARY:GEN_—NCS.NLB. 
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NCS Qualifiers 
/LIST 


/LIST 


Lists the contents of an NCS library. 








FORMAT /LIST[= filespec] 
/NOLIST 
QUALIFIER filespec 
VALUE The destination file specification for the list output. 





DESCRIPTION The /LIST qualifier allows you to obtain a listing of an NCS library. The 
optional file specification parameter allows you to store the listing in a file. 
The default file type is LIS. If you omit the file specification, NCS directs the 
listing to SYS$OUTPUT. 


You are not permitted to use wildcard characters when specifying the 
destination file. 


Note that when you use the /LIST qualifier in conjunction with qualifiers 
(such as the /DELETE qualifier) that modify the contents of the NCS library, 
NCS creates the listing after the modifications are made. For example, if you 
delete the definition module UPCASE and simultaneously request a listing, 
the listing does not include the UPCASE module. 


Listings can provide various types of information, depending on the qualifiers 
you use with /LIST. Each listing, however, contains at least the following 
information about the library: 


Directory of NCS library library-filespec on dd-mmm-yyyy hh:mm:ss 
Creation date: dd-mmm-yyyy hh:mm:ss Creator: VAX librarian Vnn-nn 
Revision date: dd-mmm-yyyy hh:mm:ss Library format: nen 

Number of modules: nnn Max. key length: nnn 

Other entries: nnn Preallocated index blocks: nnn 
Recoverable deleted blocks: nnn Total index blocks used: nnn 
Max. update history records: nnn Update history records: nnn 





EXAMPLES 
fH]  $ NCS/LIST 


This command outputs a listing of the definitions in the default NCS library 
to the SYS$OUTPUT device. 


BE $ NCS/LIST=DEFLIST/FULL 
This command outputs a listing of the definitions in the default NCS library 


to a file named DEFLIST.LIS. The listing includes the date each definition was 
inserted in the NCS library. 
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NCS Qualifiers 
/LOG 


Determines whether or not NCS verifies library operations. 





FORMAT /LOG 
/NOLOG 





PARAMETERS None. 





DESCRIPTION Use the /LOG or /NOLOG qualifier to specify whether or not you want NCS 
to confirm the result of a specified operation (such as a replacement, insertion, 
or deletion). By default, NCS does not confirm operations. 





EXAMPLE 


$ NCS/DELETE=(TJL, RRR) /LOG 


This command directs NCS to delete the definitions TJL and RRR in the 
default NCS library. After deleting the definitions, NCS issues the following 
messages: 


%NCS-S-DELETED, module TJL deleted 
YNCS-S-DELETED, module RRR deleted 
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NCS Qualifiers 
/MACRO 


/MACRO 


Specifies that the extracted definition table is coded in MACRO-32. 








FORMAT /MACRO= filespec 
QUALIFIER filespec 
VALUE The file specification for the destination MACRO file. 





DESCRIPTION Use the /MACRO qualifier with the /EXTRACT qualifier if you want to 
retrieve a definition module from the NCS library, convert the definition to 
VAX MACRO format, and then output the VAX MACRO-formatted definition 
to the specified destination file. Note that each collating sequence and 
conversion function bears a global label that you can use to pass the address 
of the definition to an NCS routine. 


You must include the destination file specification with the /MACRO 
qualifier. You cannot use wildcard characters to specify the destination file. 
The default value for MACRO-32 files generated by the /MACRO qualifier is 
MAR. 


Note that you can further define a specific MACRO-32 format with the 
/ FORMAT qualifier, as shown in the second example. 
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NCS Qualifiers 
/MACRO 





EXAMPLES 


4 $ NCS/EXTRACT=DOWNCASE/MACRO=MY_MACRO 


This command directs NCS to extract the definition DOWNCASE from the 
default NCS library, convert the definition to VAX MACRO format, and then 
output it to file MY_MACRO.MAR. The following example shows an NCS 
definition module converted to VAX MACRO: 


.PSECT NCS$RO_DATA NOVEC,NOWRT,RD,NOEXE,SHR,LCL,REL,CON,PIC,LONG DOWNCASE: : 


-LONG ~X00000158 , ~K00000000 , ~X00000000 , ~X00000000 
-LONG ~X00000000 , ~X776F6408 , “X7361636E , ~XO0000065 
-LONG ~X00000000 , ~X00000000 , ~X00000000 , ~X00000000 
-LONG ~X00000000 , ~X00000000 , ~X00000000 , ~X00000000 
-LONG ~X00000005 , ~X00000158 , ~X00000000 , ~XO00000000 
-LONG “~X00000000 

.LONG ~X00000000 

LONG ~X03020100 , ~X07060504 , “XOBOA0908 , ~XOFOEQDOC 
-LONG “~X13121110,~X17161514, “X1B1A1918, “X1F1E1D1iC 


-LONG  “%X23222120 , ~X27262524 , “X2B2A2928 , “X2F2E2D2C 
-LONG “%X33323130 , ~X37363534 , “X3B3A3938 , “X3F3E3D3C 
-LONG “~X63626140,~X67666564, “X6B6A6968 , “X6FEE6D6C 
-LONG °X73727170,~X77767574, ~X5B7A7978, “X5F5E5D5C 
.LONG “~X63626160 , ~X67666564 , “X6B6A6968 , “X6FEE6DEC 
-LONG  °X73727170 , ~X77767574 , “X7B7A7978, “X7F7E7D7C 
-LONG) “XF3F2F1iFO,“XF7F6F5F4, “XFBFAFOF8, “XFFFEFDFC 
. END 


= $:_ NCS/EXTRACT=DOWNCASE/MACRO=MY _MACRO/FORMAT=256 


This command directs NCS to extract the DOWNCASE definition from 

the default NCS library, as in the first example. However, this command 
explicitly specifies that NCS convert the definition to the MACRO-32 format 
for use with the Run-Time Library routine LIB{}MOVTC instead of the default 
NCS format. The following example illustrates the converted definition: 


.PSECT NCS$RO_DATA NOVEC,NOWRT,RD,NOEXE,SHR,LCL,REL,CON,PIC,LONG DOWNCASE: : 
LONG ~X03020100, ~X07060504, “XOBOA0908 , “XOFOEODOC 
-LONG ~X13121110,~X17161514, “X1B1A1918, “X1F1E1D1C 
-LONG “%X23222120 , “X27262524 , “X2B2A2928 , “X2F2E2D2C 
-LONG  %X33323130 , ~X37363534 , “X3B3A3938 , “X3F3E3D3C 
-LONG “~X63626140, ~X67666564, “X6B6A6968 , “X6FEE6D6C 
-LONG “°X73727170,~X77767574, “X5B7A7978, “X5F5E5D5C 
-LONG ~X63626160 , ~X67666564 , “X6B6A6968 , ~X6FEE6D6C 
-LONG = °*X73727170 , ~X77767574, “X7B7A7978, “X7F7E7D7C 
-LONG %X83828180 , ~X87868584 , “X8B8A8988 , “X8F8E8D8C 
-LONG “~X93929190 , ~X97969594 , “X9B9A9998 , ~XOFQ9ESD9C 
-LONG “XA3A2A1A0,~XA7A6A5A4, “XABAAAQAS, ~XAFAEADAC 
-LONG “~XB3B2B1iBO,~XB7B6B5B4, “XBBBAB9B8 , ~XBFBEBDBC 
-LONG “XESE2E1E0, “XE7E6E5E4, “XEBEAEQE8 , “XEFEEEDEC 
-LONG) “XF3F2F1D0,~XF7F6F5F4, “XFBFAF9OF8 , ~“XDFDEFDFC 
-LONG ~“XESE2E1E0, ~XE7E6ESE4, “XEBEAE9ES , “XEFEEEDEC 
-LONG) “XF3F2F1FO,“XF7F6F5F4, “XFBFAFOFS8 , “XFFFEFDFC 
. END 
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NCS Qualifiers 
/ONLY 


/ONLY 


Limits the modules being listed. 








FORMAT /ONLY=module[,...] 
QUALIFIER module 
VALUE The module or modules to be listed. 





DESCRIPTION Use the /ONLY qualifier with the /LIST qualifier to specify which definition 
modules in the NCS library you want listed. If you specify more than one 
definition module, separate the module names with commas (,) and enclose 
the list in parentheses. 


You may use wildcard characters to specify the definition module(s). 





EXAMPLE 
$ NCS/LIST/ONLY=(M* , P*) 


This command directs NCS to list only the definition modules that have 
names beginning with the letter M or the letter P. 
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NCS Qualifiers 
/OUTPUT 


/OUTPUT 


Specifies the output definition file. 








FORMAT /OUTPUT= filespec 
QUALIFIER filespec 
VALUE The file specification for the destination file. 





DESCRIPTION You use the /OUTPUT qualifier with the /EXTRACT and /COMPRESS 
qualifiers to specify a destination file. 


Use the /OUTPUT qualifier with the /EXTRACT qualifier to specify a file 
to store the definitions extracted from an NCS library. The default file type 
is NCS. Note that the new definition file is not the same as the definition 
file used to originally create the definition. NCS does not store the original 
definition file, only the resultant definition. 


Use the /OUTPUT qualifier with the /COMPRESS qualifier to specify 

a destination library file for the compressed library. If you do not use 

the /OUTPUT qualifier with the /COMPRESS qualifier, NCS puts the 
compressed library in a new version of the default NCS library. The default 
file type is NLB. 





EXAMPLES 


1] $ NCS/EXTRACT=(UPCASE , DOWNCASE) /OUTPUT=USER : [DOE] NEW_DEFS.NCS 
This command directs NCS to extract two definitions (UPCASE and 
DOWNCASE) from the default NCS library and to store them in a file 
named NEW_DEF.NCS. 

fF] = $ NCS/COMPRESS/OUTPUT=USER : [DOE.NCS]NEW_LIB 


This command directs NCS to compress the default NCS library and to 
store the compressed version in an alternate NCS library specified as 
USER:[DOE.NCS]NEW_LIB.NLB. 
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NCS Qualifiers 
/REPLACE 


/REPLACE 


Replaces one or more definition modules in the default NCS library with 
modules from the specified input file. 





FORMAT /REPLACE 





PARAMETERS None. 





DESCRIPTION _ Use the /REPLACE qualifier when you want to replace one or more library 
modules with definitions from the specified input file. If a replacement 
module in the input file does not have a corresponding module in the NCS 
library, NCS inserts, rather than replaces, the new module in the library. If 
you do not explicitly specify a qualifier for the NCS command, the default is 
the /REPLACE qualifier. 





EXAMPLE 


$ NCS MY_DEFS 


This command directs NCS to replace each definition in the default NCS 
library with a corresponding definition from the input file, MY_DEFS.NCS. 
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NCS Qualifiers 
/SINCE 


/SINCE 


Limits a library output listing to definitions inserted after the specified 
date and time. The most recent definitions are listed first, and are in 
alphabetical order. 








FORMAT /SINCE[= time] 
QUALIFIER time 
VALUE The time (and date, where applicable) that NCS uses as the reference point to 


begin accumulating the appropriate list of modules. 





DESCRIPTION _— Use the /SINCE qualifier with the /LIST qualifier to list only modules 
inserted into the library after the specified time (and date, where applicable). 
You can specify an absolute time or a combination of absolute and delta 
times. For details on specifying times, see the VMS DCL Dictionary. 


If you omit the /SINCE qualifier, NCS lists all the modules in the library 
unless you use a different limiting qualifier (/BEFORE or /ONLY). If you 
specify the /SINCE qualifier without a time or date, NCS lists only the 
modules inserted today. 





EXAMPLES 


f] $ NCS/LIST/SINCE=31-DEC-1988: 10:00 


This command directs NCS to list only modules inserted in the default NCS 
library after 10 am. on December 31, 1988. 


A$: NCS/LIST/SINCE 


This command directs NCS to list only modules inserted in the default NCS 
library today. 
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National Character Set Definitions 


This appendix lists the contents of the default NCS library (NCS$LIBRARY). 
The library includes 13 collating sequences and 24 conversion functions. 


! Danish Collating Sequence 


Danish = CS( 
SEQUENCE = (%XOO-"N", aS ha HOMeN ZT WAM not. MAM pea BE i ake ee %XDO, 
%XDE, %XFO, %XFE-%XFF), 
MODIFICATIONS=("at—"z" = We wmArluRy = a WRN se uD non ee 
Woo _ ‘Ee i es = sa aan romaine = Oe, ng = HOt, orig = i 8 hee 


wiring = wy, waning = ae Natnan = mAnavAt Not = WAY ot = or, 
1S ss oes . ea = os = Ky > wat a sy nan 
et-"an = nee mpl LL mat = ab Ne MEMS x BON, "S = 6 : 

Not = NOM Wreath = al A pea a = ye, "aE" = Or mam = nso, 


Nott = "E", "" < %X00)) 

+ CS ( SEQUENCE = (3XOO-"A", TAN NAM mB ree. pts A ke Le 
‘pron ps bu Nate GLa MS Lens Sa se Se rE" HOM nOhondn ap it al eee 
Torna, nore, syn ny day Ae "EN agit nAN Wawa ee a ae 
$XDO, %XDE, %XFO, %XFPE-%XFF), 

MODIFICATIONS=("a"=-"Z" = MAI SZ A Watorygm o HAS Ma mae = myers) y 

+ REVERSE (_NATIVE) ; 


ZK-6574-HC 
!  Danish-to-Multinational Conversion Function 


Danish _NRC_to Multi = CF( 
CF = IDENTITY, MODI = ( 
nano = nA 
" cr" = Oy, ier 
myn = "gn" ; 
Wy = wAt 
waAw wey : 
Ce War 
we ce Mgt 
my oN ‘ 
wp nan 
" 


aos tay 


, 
wt = %X00)); 
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National Character Set Definitions 


! Dutch Collating Sequence 


DUTCH = CS ( 

SEQUENCE = (%XOO-"N", ny nOnongN "EN, ngn WA Oe ee ae UF a ae %XDO, 
&SXDE, %XFO, %XFE-S%XFF), 

MODIFICATIONS=("al"="z" = Bey ae vANluAn _ Dit ve" es ro Wolpe _ "EM 
upwlnga me sa nOwongn = tom, mop ep = 0 ae nyu = “ys, WaNotaW NZ ) 
wanton = VANE", net _ 168. Manlove x LS ae ee Us Wat x aS Bue 
nmeotrongnm o 8 Wott = mgt Wawona noe sh a = nyt Ng = "OE", 
mat = "ss", Not = "eg", wt < %X00) ) 

+ CS ( SEQUENCE = (%XOO-"A", WAnovAN MBean ner. Ppte"E, HENNE 
a at Be a a Ora. hae "eh, "e—E", HON, NOM MOM HpPHAN_M "BN, 
nonengy ae rea iyi yt nye oP Ae "RE", ng "AN, i ee ae a Se 
%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"—"z" = yy Ae WaMowy it ay ei Be ee i a = my inyny) 

+ REVERSE (_NATIVE) ; 


ZK-6576-HC 
! EDT VT2 Conversion Function 


EDT VT2xx = CF ( 
CF = IDENTITY, MODI = ( 
X00 = tel hae 
%XO1 = "A", 
X02 = "“B", 
%X03 = "*C", 
%X04 = "4D", 
$XO05 = "“E", 
SX06 = "SF", 
%XO7 = "4G", 


&X08 = "4H", 
SXOA = "<LF>", 
%XOB = "<VI>", 
%XOC = "<FF>", 
%XOD = "<CR>", 
SXOE = NANT, 
SXOF = HAO: 
&X10. = APN, 
%X11 = "49", 
Sy12= HAR, 


%X13 = Age 
%X14 = wag 
&X15 = wr, 
&X16 = Ae 
&X17 = wayn 
X18 = Weg 
%X19 = Way irs 
SX1A = a 
%X1B = "<ESC>", 
EXC = WANN 
%X1D = aa | ¥ 
SX1E = ee 
SXLF = " meg 
&X7F = "<DEL>", 
SX80 = "<X80>", 
%X81 = "<xX81l>", 
SX82 = "<X82>", 
%X83 = "<X83>", 
%X84 = "<IND>", 
%X85 = "<NEL>", 
%X86 = "<SSA>", 
%X87 = "<FSA>", 


National Character Set Definitions 


X88 = "<HTS>", 
%X89 = "<HTJ>", 
%X8A = "<VTS>", 
%X8B = "<PLD>", 
%X8C = "<PLU>", 
%X8D = "<RID>", 
%X8E = "<SS2>", 
%X8F = "<SS3>", 
X90 = "<DCS>", 
%X91 = "<PU1>", 
%X92 = "<PU2>", 
%X93 = "<STS>", 
%X94 = "<CH>", 
%X95 = "<MW>", 
%X96 = "<SPA>", 
%X97 = "<EPA>", 
X98 = "<X98>", 
$X99 = "<X99>", 
tX9A = "<X9A>", 
%X9B = "<CSI>", 
%X9C = "<ST>", 
%X9D = "<OSC>", 
%X9E = "<PM>", 
%XOF = "<APC>", 
%XAO = "<XAO>", 
%XA4 = "<XA4>", 
%XA6 = "<XA6>", 
SXAC = "<XAC>", 
%XAD = "<XAD>", 
SXAE = "<XAE>", 
SXAF = NEXAFS, 
%XB4 = "<XB4>", 
%XB8 = "<XB8>", 
%XBE = "<XBE>", 
%XDO = "<XDO>", 
%XDE = "<XDE>", 
%XFO = "<XFO>", 
%XFE = "<XFE>", 
SXFF = "<XFF>", 
we %X00));3 

ZK-6577-HC 

{ English Collating Sequence 
English = CS( 

SEQUENCE = (%XO00-"N", 3 Re WONANZ", WEN MON mA", W [way be Pe ae %XDO, 
%XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"zZ" = Le a Ale wmAnrongy = mat ous fs now, 8 Re _ HE", 
te en a wt, nuova = "tor, nop tyy = a ny = oye Wanita os AM 
Walotteal = MANO NBN et s bs Oh Be nating o Ls mp moiny te = Le wan = "y, 
rearaonmou = NON, tow = "Or Hy way = "UN; ny" = be aba ta" = "OE", 
NaN = "ss", "opt! = ner, wee < %XKO00) 

+ CS ( SEQUENCE = (%XO0O-"A", eAY tN NB NaCt, non, MDMA" EM We an EM 
Le a ei mgr, aS fas NEM toMy HOM ath, Npr—ot RY a 
ngvarg | WET PT a Le ea ay, ue ge oy Ae gn ORI Mee DM he ela soa 
%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"=-"z" = NAN wahimy tt = EArt: WANA yn = wire ry) ) 


+ REVERSE (_NATIVE) ; 
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National Character Set Definitions 


! Finnish Collating Sequence 


Finnish = CS( 

SEQUENCE = (%XO0-"N", "HN, noOrangy HANNAN mat nor nA, non 2 ee 
"{"-"s") &XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = MANNE nanan = vA nol = ror. Woe mes os "EN, 
npn gy as wT, nore = to", "OM = OM rye ng = not, nip inn = ee 
watongnm = Pe Wau lta = Peat EM nen ‘es one wanrinvagn = LN LS 
Watley "Tr WaW ont, rerinan ton, Wot net rorengy = eget 
May Mate ca Le aN (a "OR", wa "ssn, Not = "E", Wit %X00) ) 

+ CS ( SEQUENCE = (%XO0-"A", VAM A np WGN OSL a) B aS cae UE eh ae 
Mt TI os Bi ee De moe "A", "Er, se ee HOMO, mpNaMRM Nee 
Recs 8 Le a 8 aL ye a) se Ae ay ALE yh ae AN " [v-" \ ae Ue Sa) an 
SXDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = mAN Ng Wwanoryn os mAningy Ap ee apt 2 my anyny) 

+ REVERSE (NATIVE) ; 


ZK-6580-HC 
! Finnish to Multinational Conversion Function 


Finnish NRC_to Multi = CF ( 
CF = IDENTITY, MODI = ( 
" [" = wat P 
myn ue nor, 
Hp WH 


WAT nin 
f 


wy — man 
= e 


’ 
a ea 
TLD esses 
mp om wan 

’ 
Wath et 
" = %X00)); 
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! French Canadian to Multinational Conversion Function 


FrCan_ NRC _to Multi = CF( 
CF = IDENTITY, MODI = ( 
man = tat r 


w [" = war, 


myn = Walt 
"yp" = ver 
WAM Ls BL 


mv ee gt 
i ! — west 
{" = "é", 
wee owe 
| ur 
wow oo war 
} eur 
Met = Qn 


0 =:8K00))e 
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French = CS( 


National Character Set Definitions 


! French Collating Sequence 


SEQUENCE = (%X00-"N", "He HONANZ "EY ng AN, oe myrinst SxXDO, 
%SXDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = HANAN ZH nAniongn = "A", non _ i oe Te A SL = "ER", 
ee — es nOovongu = nor, wep ntye = ng, non = aye waulngn a 
WaN_tew & mANong Hot = "c", Wanna = "EN en LL wat = on, 
Wwamingw = "ON, Nott = ngr, Wyong = nyt aay = ry "Ee" = "OER", 

NRW ss “eo Nott = NEN, ut < %xX00)) 

+ CS( SEQUENCE = (%XO0O-"A", wArnAn MBN NC Jol MprothN Up 
pt eT pes Oe eS Se "A, "en, oh nOManOn, Os ne tt 
che 2s Oke ngringn, nyninyt a a A "EM ng nAN Oe Le GLE Sue ee 
SXDO, %XDE, %XFO, %XFE-%XFF), 


MODIFICATIONS=("a"=' 


Yet = MAM ange watrowye A Ata Th, 


+ REVERSE (_NATIVE) ; 


Nast = my anyiry y 


ZK-6583-HC 
!  French-to-Multinational Conversion Function 
French NRC_to Multi = CF( 
CF = IDENTITY, MODI = ( 
nen = tg : 
ranma wan . 
1 ee on ; 
" \ tom ¢ " 7 
"] wos nen : 
Ai { + é uF ; 
" | wo nyt 
" } wo o— e we P 
tag = Ng : 
WA e "oo 1 é ih : 
WagMm = ong ; 
WAom = Net" : 
way" = wot ‘ 
tt ~a" = "Ss Ww F 
Moet = wan ‘ 
WSs L woo «6 tL Ww ; 
Mon = NBN 
Wet os MyM Z 
"" = $X00)); 
ZK-6584-HC 
! German Collating Sequence 
German = CS ( 
SEQUENCE = (%XO00O-"N", "N's Ure Z "EN, i mA " iets, Le Rake lar %XDO, 
%XDE, %XFO, %XFE-%XFF), 
MODIFICATIONS=("a"—-"z" = MANA ZN, wAuonan = VAN nC = A Gos WRit wp = aa 


epTwongy = ae worn = MON acpi = a ae nyu = ny Watts NAW 
Wwatrotgaw = "Ar" A", toi = no raronen os a worry a Watt LD Se 
Wwatonanw x HOM, Wott = Not Wy 8 hae age — ee aes WEN = "OE", 

raw = nosh. Not = Et nmiog %X00) ) 

+ CS ( SEQUENCE = (SXO0-"A", AM oA = aed OL ew, apse 08 Res ae 
pT es Ae ee morte N, “ye, net, HON, NO, ip itty pat 
orate AP 8 a 8 Be ape ye Le dae Ze Ee rae wa Le i Cae aah 
%XDO, SXDE, %SXFO, %SXFE-SXFF), 


MODIFICATIONS=("a"-"z' 
+ REVERSE (_NATIVE) ; 


= VANONZ" Heap thes thguate = wAnvaete, 


ie a = atone ty) 
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National Character Set Definitions 


German NRC_to Multi 
CF = IDENTITY, 

wan = "gg" 

weit ss wan : 

mn = won : 

my wo wge : 

Le lee ae 

A ee 

a ee be 


WoW "aM 


wt = %X00)); 


Italian = CS( 
SEQUENCE = (%xX00 
SXDE, %XFO 


{ German-to-Multinational Conversion Function 


= CF ( 


MODI = ( 


ZK-6586-HC 


! Italian Collating Sequence 


-"N", "NY; WON LINZ ae WEN "ON NAN, [‘<-" ay wenems ar %XDO, 


1 %SXFE-% 


XFF), 


MODIFICATIONS=("a"—"z" = VANANZ", vArionan = WA", OM = Cry 0 a = "Er 


npr 
wanotan = 
Wetengm = 
man = Noon 
+ CS( SEQUENCE = 


SXDO0, %XDE 


"T ae non 
nAronggy ; 
tO ton 


! 1) 
, GG = 


-"6O" = 1 wove = 8 ny = ue alae waning o wa 
Nol = nen. ranionean = et 7 ot ee may = aS Be 
= ng . Hyatt won, a a = ep ae "—" = "OE", 

EN "" < %$X00)) 


(3X00-"A", nAnvAn "Bronco am, Mprat"Et, 00 a 
wey A es ON 
novengn mOrongr, 


, %SXFO, 


noreen su) ° L "Ee", "Or, nOMsNON, Mpa ae 
ayony nye wae "ER", Le nA, " pram y a Gah 
&XFE-%XFF) , 


, 


MODIFICATIONS=("at=-"z" = Wy Ae wanrongw wAnouet mati rgyn = my enyry) 
+ REVERSE (_NATIVE) ; 


Italian NRC _to Multi 


ZK-6587-HC 


! —- Italian-to-Multinational Conversion Function 


= CF ( 


CF = IDENTITY, MODI = ( 


wan = Wen 
nen =< wen 
" cs _ ea 
milan Not, 
ns wo Wem 
wy ba Sa 
sf = rag 


a = "welt 
, 


! We wou 
} ée", 

iii 1 aw wo 
~ -—] 1 , 


nt = %X00)); 


ZK-6588-HC 


National Character Set Definitions 


! Multinational Collating Sequence 


Multinational = CS( 

SEQUENCE = (%X00-"N", "nN", WON—NgZ "RN, ng as ele De me GLa Le %XDO, 
%XDE, %XFO, %*XFE-%XFF), 

MODIFICATIONS=("a"-"z" = MAN ANZ wAnroiuAw = RS OM ee IU ee ee 
wpa = Te waAwlwdiyr = MOM np gpi = MON wen he ae Hatongn = ene) 
Want aw = nAningH Meu = "CO", "etongw = WEN, wpm Es aL aS 
Hanis = "OW, Mgt = NOH Ata = Ny nay =a wy" nm = "OE", 

"BY = "SS me" = "Ee", mm < %&X00)) 

+ CS( SEQUENCE = (%XO0O-"A", nAtravan, RESUS. OME ONDE Ee: 0 ee Se 
Prt Th i es Wotan, ae ne", NO", Gato tprongH nan, 
monenyn mgr ange mynonyt ayy a Ae "Ee", a Lue wan " [vay UP ae ae 
%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = cy a ae waning waning manag = wayyy 

+ REVERSE (_NATIVE) ; 


ZK-6589-HC 
! Multinational_1 Collating Sequence 


Multinational 1 = cS( 

SEQUENCE i (3XO00O=—"N", "HN", NOUaenZn, "RN, "ON nA ih Fae Ne A ci Fa %XDO, 
SXDE, %XFO, %*XFE-%XFF), 

MODIFICATIONS=("a"—"z" = NAAT wAnongy = vat, ev = Ne ee = ob 
i ee = "TN WAuoudgy "Or, wom luiye = sgt, wy yt Wanonge = Nyt 
Wana = vArong tom" = bis OU nmaninen = "EY, id = "I", wat = nye 
Wearing = "oO", Wow = "On, Myton = un Wa ny" = myn "am" = "OE", 
wan = "Ss", Not = "ce", we < %X00) ) ; 


ZK-6590-HC 
! Multinational_2 Collating Sequence 


Multinational 2 = CS( 
SEQUENCE = (%XOO-"A", WALA" sd = Ra ee non. nya 0S he we OT 
A aa Sal Dee Oe ae 3 "Ee", uso ae AOMetO" , MPM no, notary, 
ngage, Sy Le Ae sha "On HAN oe Le MENS EM %XDO, 
SXDE, %XFO, %XFE-%XFF), 
MODIFICATIONS=("al"-"z" = NAS ey We a = nAnonyy ware tyy = Ney. 
"" = %$X00)); 


ZK-6591-HC 
! Miultinational-to-Danish Conversion Function 


Multi_to Danish _ NRC = CF ( 
CF = IDENTITY, MODI = ( 
niin = "@", 
wan = ss (e 
A ae ae 
WoO" ee 


eye — Nan 


Wa oe wv 
a 
Net a Wyn 
tot = 


ba ~ ”~ “~ 


"aye =— H,.zftY 


, 
i %X00) ) ; 
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National Character Set Definitions 


! Miultinational-to-Finnish Conversion Function 


Multi_to Finnish NRC = CF( 
CF = IDENTITY, MODI = ( 
nan = "yr, 
"AW = yea 
now = ane 
nig = WAN 
ae aS 
mars La 
aie aoe 
NSM ee ee 


wot — man 


7 
"" = %X00)); 
ZK-6593-HC 
! Miultinational-to-French-Canadian Conversion Function 


Multi_to FrCan_NRC = CF ( 
CF = IDENTITY, MODI = ( 
wan = Ta 
we" ss ee 
te" = Ny 


Wwe" = sa a 


mem ia myn 
r 

wan . onde 
Cc = 1", 

net oo tan 
r 

nom os win 
' 

ww omen 
uF Ls 

nant — mot 
GS "an, 


"Ht = %X00)); 


ZK-6594-HC 
! Multinational-to-French Conversion Function 


Multi _to French NRC = CF( 
CF = IDENTITY, MODI = ( 
wet a nen 
nonin wy 
now sony ; 


manos wan 


ett = sae 
mam os i ae 
WE om Le a 
wat ae Sue 
won = Migtaptt 
Wwe = "wal, 
wet = Ae 
Nem = Nren, 


wot = WAS. 
a eg 
"go" = WAGe 
UCU SoMa 
"mat = a oh 
mae = tay 


n= %X00)); 
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National Character Set Definitions 


! Miultinational-to-German Conversion Function 


Multi_to_ German NRC = CF ( 


CF = IDENTITY, MODI = ( 
"en = NEN 
ware {", 
wan = ALU 
nye = "y a 
WHR = NA 
Naw ce WT 
NEw a WH 


HM = NPN 


mt = %X00)); 
ZK-6596-HC 
! Multinational-to-Italian Conversion Function 


Multi to Italian NRC = CF ( 


CF = IDENTITY, MODI = ( 
nen = "en 
"gr = nar, 
wo tt = wf [" 

tA 
wat oo ie 
Now = ee 
wana ap a 
nena Nyt, 
nyt He 
Wwe" = wt | ae 
eS = " ee 


nm = %X00)); 


ZK-6597-HC 
! Multinational-to-Lowercase Conversion Function 


Multi_to_ Lower = CF( 
CF = IDENTITY, MODI = ( 
naningn = Nattitton 
warn ya = se a 
oyrirye = Aa ts UE 
"= %X00)); 
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National Character Set Definitions 


{ Multinational-to-No-Diacriticals Conversion Function 


Multi_to NoDiacriticals = CF( 
CF = IDENTITY, MODI = ( 

mAnongan = "AN 
2 iS BOM 
te "ET, 
wpe WEN. 
ryreroy = anon, 
"Onn = tor, 
Ne = Oh 
2G cn 6 8 aoe 
wy = ue aide 


wantonan = va, 

"ot = no", 

Wwanroten = ven, 
wpe z ah Cr 

' rane = Myteatot, 
' "o", 


mm! 
ronitgsn = 
Not = Non 
Hye = oe 
Maye as ty 


wR = MAR 
"Eg" = "On", 


mat = "ss", 
=? 

Not ss "ae", 

Yet = "oe", 


"Ml = %X00)); 


ZK-6599-HC 
! Multinational-to-Norwegian Conversion Function 


Multi_to Norwegian NRC = CF ( 
CF = IDENTITY, MODI = ({( 
nar = "a" 


An = Wy " 
wR oo [", 
Wg = mr, 
uty _ PAM 
tenia on yu 
wat os Bye 
Wott = nen 
Wot = MN | ae 
a Wat 
"i w= %X00)); 


ZK-6600-HC 


A-10 


National Character Set Definitions 


! Miultinational-to-Swedish Conversion Function 


Multi_to_ Swedish NRC = CF ( 


CF = IDENTITY, MODI = ( 
nan =- [ " , 
"Aw oon J", 
i nan : 
"ow = wy . 
wit oa wan ; 
ee ae 
wan = +s } " ’ 
wet = wy 7 
"wo" = | " ' 
we = («MAT j 
"" = %X00)); 
ZK-6601-HC 


! . Multinational-to-Swiss Conversion Function 


Multi_to Swiss NRC = CF( 
CF = _IDENTITY, MODI = ( 


wat os net. 
wa we awe 
Bhoits = YN 
"a" oa i ue 
neuen oT. 
we = mp 
ng os ERM 
"eo" i= ae 
mew = isl are 


mat = he 
Wat oti = De ae 


a %X00)); 
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! Multinational-to-United-Kingdom Conversion Function 


Multi to Uk_NRC = CF( 


CF = IDENTITY, MODI = ( 
net = "en 
nt = %X00)); 
ZK-6603-HC 


! Multinational-to-Uppercase Conversion Function 


Multi_to Upper = CF( 
CF = IDENTITY, MODI = ( 

Watton -_ NAN ANZH 
Watlong wy os WAY une 
marian a Nr oNyN. 
"E" = "OE", 
1AM "ss", 
nt = %X00)); 


ZK-6604-HC 
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National Character Set Definitions 


! Norwegian Collating Sequence 


Norwegian = CS ( 

SEQUENCE = (SXO0-"N", "Hh", NOMA ZH "EN, Ow, "Ar 0 ae ee %XDO, 
%XDE, %XFO, %XFE-%SXFF), 

MODIFICATIONS=("a"—"z" = uy LY Ale wAw ona = "At", won = "cl", Be rm 
oe wr, nOrorgn = now, gt = nO, merge = ng nip myn nyt 
wamlmanw ss mau Watlirat o rAni gt Melt = NEN WEenotatr = a ae 
wowlny ey a mat = 0S MEMS = NOM, NEW = ng Hott me nO, 
rye ergy = nyt nS a a ay wan = "AR", N—" = "OER", "g" = "gs", 
wat AM Noe = mE "mM < %X00)) 

+ CS( SEQUENCE = (%X00-"A", mAronAan "BV "Ct, HOW NpNonAt OP A 
pe i a a ae "NY, ne", nO ie Ae a 6 Lue mpramRY Be ae 
TSM ngrar"gr, myn ry ue alee Ae vy, nn "Ar, ee UF 
%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"=—"z" = MANoNZ Warring nAn nee WAN = my eryry ) 

+ REVERSE (_NATIVE) ; 


ZK-6605-HC 


! Norwegian-to-Multinational Conversion Function 


Norwegian NRC_to_ Multi = CF ( 
CF = IDENTITY, MODI = ( 
wan = wan ; 

as wR 

m\n = "gg" ; 

wy me A 

WA wg . 

" x = re 
ae ee ; 
Hse et 
a Gee Naw.. 


Wom om gy 
’ 


wi %X00) ); 


ZK-6606-HC 
! Portuguese Collating Sequence 


Portuguese = CS ( 

SEQUENCE = (SXO0-"N", wn, WOM MZ EY, Ng TAG ce ee WE ote %XDO, 
SXDE, %XFO, %XFE-%SXFF), 

MODIFICATIONS=("a"="z" = HANNE, wAnronan = "aA", og = "ol, nye mpi = as ae 
ie es = oe ae wOuingn = "oO", wont = ie © Oa wy = ye wanton = tA, 
nano gan = nAra ER" Coy = Ce, waning = "Ee", i = ay mat} = pe 
rorminair = 1 © ar tat = "On, morongen = a 0 ie "yn = bs aaa "Et = "OE", 

"man = "Ss", Wott = "EE", rere < %X00) ) 

+ CS ( SEQUENCE = (%XO00O-"A", nA ar AN mB neM HD Ma NET La ae 
A Oe ae er "N", bt SE "ON. HOM aM mpromR "Bg", 
ES eM cd O hace 8 he mytenryy yee Gala M2 "RN "Ou, nA " {"-" ‘ ars " { Mes Hg er 
%XDO, %XDE, %XFO, *XFE-%XFF), 

MODIFICATIONS=("a"-"z" aa WAREZ wating tr = UAT, oF 6 ia = nary) ) 

+ REVERSE (_NATIVE) ; 
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National Character Set Definitions 


! Spanish Collating Sequence 


Spanish = CS( 

SEQUENCE = (%X00-"B", nes "CH", "HE, Ana Pe 0 ee Ne "N", nO Me "EY 
WOM, nAN sd i SL PF ee %XDO, &XDE, SXFO, SXFE-%XFF), 

MODIFICATIONS=("a"=-"b" _ ee Wqrotypw NptanKy Woy then t= DD Ti Ale 
nAn ong = wae Oe OL = tet npn = 2s es nOnondgey = OM. 
upp nie = Ohm wy = ee waning = AM Watate" =_ By eas Oh 
vattinanm Le ae wooly ia mae ont; Wwatluem = se Wot = ngiits 
Watt 8 Be se al = yn won = Ls aL "Ch" = ne, "Dp" = Ay Oar 
Wont = ‘ets. Yon" = WOH: "oh" = VCH. woos apy VIL" = RL 
"TL" = aT EN = "OE", WAM = "oS". Not = Za hae wirig %X00) ) 

+ CS( SEQUENCE = (%XOO-"A", mAnonAy NBN, rot, © Le ria HEE 
He wy a aL norene ae Ew, MOM WOrarOn, Nps tA, AM, 
Vora | ngrsey, SY a AL ny, a Ae a, ng oA, Se Le oe a a 
SXDO, SXDE, %SXFO, %XFE-SXFF), 

MODIFICATIONS=("a"—"z" = MR manly = wAnoe Te Wait a = DS Gah le 

+ REVERSE (NATIVE) ; 
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! Swedish-to-Multinational Conversion Function 


Swedish _NRC_to Multi = CF( 
CF = IDENTITY, MODI = ( 

war = Lit, 
" ca = ue 
WN a uO, 
"yj" = uA 
HAW ete 

wy man, 
A ee ae 
SESE cee GIO 
"yt = wen 
ea GL 


"" = %X00)); 
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! Swiss-to-Multinational Conversion Function 


Swiss NRC_to Multi = CF( 
CF = IDENTITY, MODI = ( 
wen = "a", 
NQn s rad? 
"yt = ne 
wr = non, 
vy] wo wet 


WAT 


t> 
los 


" reo 6A 
= e 1 


2s 
= 
il 


wan 
our 
" { wos gn 
WE oe onset 
| <2 our 
Tr on | rT eT 
} Ug 


"Ys %X00)); 
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{ United-Kingdom-to-Multinational Conversion Function 


Uk_NRC_to Multi = cCF( 
CF = IDENTITY, MODI = ( 
ngn =—- ‘iw £ " P 


mms &X00)) 7 
ZK-6611-HC 


A-13 


Index 





A 


Alternate NCS library, specifying 
See /LIBRARY qualifier 

ASCII SPACE character 
using as pad character ¢ NCS—10 
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